home *** CD-ROM | disk | FTP | other *** search
ffffppppaaaatttthhhhccccoooonnnnffff((((2222)))) ffffppppaaaatttthhhhccccoooonnnnffff((((2222)))) NNNNAAAAMMMMEEEE _ffff_pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff, _pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff - get configurable pathname variables SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>> _llll_oooo_nnnn_gggg _ffff_pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff _((((_iiii_nnnn_tttt _ffff_iiii_llll_dddd_eeee_ssss_,,,, _iiii_nnnn_tttt _nnnn_aaaa_mmmm_eeee_))))_;;;; _llll_oooo_nnnn_gggg _pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_pppp_aaaa_tttt_hhhh_,,,, _iiii_nnnn_tttt _nnnn_aaaa_mmmm_eeee_))))_;;;; DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The functions _ffff_pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff and _pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff return the current value of a configurable limit or option associated with a file or directory. The _p_a_t_h argument points to the pathname of a file or directory; _f_i_l_d_e_s is an open file descriptor; and _n_a_m_e is the symbolic constant (defined in _<<<<_ssss_yyyy_ssss_////_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>) representing the configurable system limit or option to be returned. The values returned by _pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff and _ffff_pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff depend on the type of file specified by _p_a_t_h or _f_i_l_d_e_s. The following table contains the symbolic constants supported by _pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff and _ffff_pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff. The return value is based on the type of file specified by _p_a_t_h or _f_i_l_d_e_s. ___________________________________ Value of _n_a_m_e See Note ___________________________________ ___________________________________ ______PPPP_CCCC______FFFF_IIII_LLLL_EEEE_SSSS_IIII_ZZZZ_EEEE_BBBB_IIII_TTTT_SSSS 3,4 ___________________________________ ______PPPP_CCCC______LLLL_IIII_NNNN_KKKK______MMMM_AAAA_XXXX 1 ___________________________________ ______PPPP_CCCC______MMMM_AAAA_XXXX______CCCC_AAAA_NNNN_OOOO_NNNN 2 ___________________________________ ______PPPP_CCCC______MMMM_AAAA_XXXX______IIII_NNNN_PPPP_UUUU_TTTT 2 ___________________________________ ______PPPP_CCCC______NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX 3,4 ___________________________________ ______PPPP_CCCC______PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX 4,5 ___________________________________ ______PPPP_CCCC______PPPP_IIII_PPPP_EEEE______BBBB_UUUU_FFFF 6 ___________________________________ ______PPPP_CCCC______CCCC_HHHH_OOOO_WWWW_NNNN______RRRR_EEEE_SSSS_TTTT_RRRR_IIII_CCCC_TTTT_EEEE_DDDD 7 ___________________________________ ______PPPP_CCCC______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC 3,4 ___________________________________ ______PPPP_CCCC______VVVV_DDDD_IIII_SSSS_AAAA_BBBB_LLLL_EEEE 2 ___________________________________ ______PPPP_CCCC______AAAA_SSSS_YYYY_NNNN_CCCC______IIII_OOOO 8 ___________________________________ ______PPPP_CCCC______AAAA_BBBB_IIII______AAAA_SSSS_YYYY_NNNN_CCCC______IIII_OOOO 8 ___________________________________ ||||||||||||||||||||||||||| ||||||||||||||||||||||||||| ||||||||||||||||||||||||||| PPPPaaaaggggeeee 1111 ffffppppaaaatttthhhhccccoooonnnnffff((((2222)))) ffffppppaaaatttthhhhccccoooonnnnffff((((2222)))) ____________________________________ ______PPPP_CCCC______AAAA_BBBB_IIII______AAAA_IIII_OOOO______XXXX_FFFF_EEEE_RRRR______MMMM_AAAA_XXXX 8 ___________________________________ ______PPPP_CCCC______SSSS_YYYY_NNNN_CCCC______IIII_OOOO 8 ___________________________________ ______PPPP_CCCC______PPPP_RRRR_IIII_OOOO______IIII_OOOO 8 ___________________________________ ||||||| ||||||| ||||||| Notes: 1 If _p_a_t_h or _f_i_l_d_e_s refers to a directory, the value returned applies to the directory itself. 2 The behavior is undefined if _p_a_t_h or _f_i_l_d_e_s does not refer to a terminal file. 3 If _p_a_t_h or _f_i_l_d_e_s refers to a directory, the value returned applies to the filenames within the directory. 4 The behavior is undefined if _p_a_t_h or _f_i_l_d_e_s does not refer to a directory. 5 If _p_a_t_h or _f_i_l_d_e_s refers to a directory, the value returned is the maximum length of a relative pathname when the specified directory is the working directory. 6 If _p_a_t_h or _f_i_l_d_e_s refers to a pipe or FIFO, the value returned applies to the FIFO itself. If _p_a_t_h or _f_i_l_d_e_s refers to a directory, the value returned applies to any FIFOs that exist or can be created within the directory. If _p_a_t_h or _f_i_l_d_e_s refer to any other type of file, the behavior is undefined. 7 If _p_a_t_h or _f_i_l_d_e_s refers to a directory, the value returned applies to any files, other than directories, that exist or can be created within the directory. 8 The behavior is undefined if _p_a_t_h or _f_i_l_d_e_s refers to a directory. The value of the configurable system limit or option specified by _n_a_m_e does not change during the lifetime of the calling process. _ffff_pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff fails if the following is true: _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS Read permission is denied on the named file. _EEEE_BBBB_AAAA_DDDD_FFFF _f_i_l_d_e_s is not a valid file descriptor. _pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff fails if one or more of the following are true: PPPPaaaaggggeeee 2222 ffffppppaaaatttthhhhccccoooonnnnffff((((2222)))) ffffppppaaaatttthhhhccccoooonnnnffff((((2222)))) _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS search permission is denied for a component of the path prefix. _EEEE_LLLL_OOOO_OOOO_PPPP too many symbolic links are encountered while translating _p_a_t_h. _EEEE_MMMM_UUUU_LLLL_TTTT_IIII_HHHH_OOOO_PPPP components of _p_a_t_h require hopping to multiple remote machines and file system type does not allow it. _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG the length of a pathname exceeds _{{{{_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX_}}}}, or pathname component is longer than _{{{{_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX_}}}} while _((((______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC_)))) is in effect. _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT _p_a_t_h is needed for the command specified and the named file does not exist or if the _p_a_t_h argument points to an empty string. _EEEE_NNNN_OOOO_LLLL_IIII_NNNN_KKKK_p_a_t_h points to a remote machine and the link to that machine is no longer active. _EEEE_TTTT_IIII_MMMM_EEEE_DDDD_OOOO_UUUU_TTTT A component of _p_a_t_h resides on a remote system which is not available [see _iiii_nnnn_tttt_rrrr_oooo(2)]. _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRRa component of the path prefix is not a directory. Both _ffff_pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff and _pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff fail if the following is true: _EEEE_IIII_NNNN_VVVV_AAAA_LLLL if _n_a_m_e is an invalid value. SSSSEEEEEEEE AAAALLLLSSSSOOOO _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(3c), _uuuu_llll_iiii_mmmm_iiii_tttt(2), _llll_iiii_mmmm_iiii_tttt_ssss(4). DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS If the configurable system limit or option corresponding to _n_a_m_e is not supported on the system, -1 is returned and the value of _eeee_rrrr_rrrr_nnnn_oooo is not changed. If the option corresponding to _n_a_m_e is known but of unlimited value for the given path, -1 is returned and the value of _eeee_rrrr_rrrr_nnnn_oooo is not changed. If _ffff_pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff or _pppp_aaaa_tttt_hhhh_cccc_oooo_nnnn_ffff are invoked with an invalid symbolic constant, -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error. PPPPaaaaggggeeee 3333 
